home *** CD-ROM | disk | FTP | other *** search
/ Belgian Amiga Club - ADF Collection / BS1 part 27.zip / BS1 part 27 / ABC_Dir_V1.3.adf / ABCDir.doc < prev    next >
Text File  |  1993-02-25  |  35KB  |  785 lines
  1.  
  2.                               23 février 1993
  3.                                _    ____
  4.     /\  ||)) // ||\\ || ||)) ||_ //  ||  //\\ ||)) \\// v1.3
  5.    //\\ ||)) \\ ||// || ||\\ ||_ \\  ||  \\// ||\\  ||  ©1991-93 Marc Dionne
  6.                                                                  ~    ~
  7.                      «the top dog of directory utilities»
  8.  
  9.  
  10.  
  11.  
  12.  
  13. ­­­­­­­­­­­­­­­­­­­­­­­­­­­­­ W H Y ­ A B C D I R ­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­
  14.                               ~ ~ ~   ~ ~ ~ ~ ~ ~
  15. Yeah! Why ANOTHER directory util?
  16.  - Others lack simplicity and those who have it have absolutely no versatility.
  17.  - Often, the effort is put on a 3D embossed look, not at a well structured and
  18.    sharp screen composition; 3D does NOT necessarily imply beautiful.
  19.  - None satisfied my greedy needs.
  20.  
  21. What makes ABCDirectory SOOOOO spEAcial?
  22.  - Most of its gadgets are at the top of the display so you won't have to move
  23.    your mouse up & down like madman.
  24.  - It's simple to use & VERY functional, hence the ABC.
  25.  - It looks crisp & sharp and no pixel is left to chance.
  26.  - It has quick help on neato flash gadgets.
  27.  - It is color-coded.
  28.  - It has a shell.
  29.  - It has SMART remembered & buffered dirs.
  30.  - It has definable file types which can correspond to specific actions. These
  31.    have incredible flexibility & power but are VERY easy to use.
  32.  - It's intuitive as hell.
  33.  - It has KOOL scrolling (if you have the req.library installed of course..)
  34.  - The progress of commands that go into recursive directories can actually BE
  35.    SEEN. This means that you don't only see the name of files being copied, but
  36.    that you see the loaded directory with all the entries selected & then suc-
  37.    cessively deselected & acted upon. Try it! Copy any old dir to RAM: & observe
  38.    the wonder....
  39.  
  40.  
  41.  
  42. ­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­ N O S T A L G I E ­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­
  43.                                ~ ~ ~ ~ ~ ~ ~ ~ ~
  44. Back in the summer of 1991, life was grand. I was a fervent BBSer who wrote tons
  45. of messages, replied to everyone & downloaded [almost] every new file with
  46. excitement. Then, on a happy & sunny day, I discovered SID v1.06. I was REALLY
  47. impressed! This was the utility I had been waiting for! Its right mouse button
  48. scrolling & its double click actions were revolutionnary & I loved them right
  49. from the start. It was far from perfect, but it did a great job at moving all
  50. those downloaded files around. I was in happy-land until I came face to face
  51. with a REALLY weird crash. I beleived in an update that would solve this annoy-
  52. ing bug which made it unusable, but it took forever to materialize.... Humpf!
  53.  
  54. I had always wanted to program my very own dir util which would fulfill my
  55. picky needs, so I grabbed Lattice/C (now SAS/C) on my B-DAY. This is where my
  56. BBS activity & my sleep went close to nil. I programmed an ANSI optimizer
  57. [ANSIMize], an ANSI editor [FANSI] & then jumped right into my big project
  58. in the beginning of December 1991; the AMIGA community was due for the greatest
  59. dir util of all times: ABCDirectory !!
  60.  
  61. After a year of hard work, I am very proud to release this dir util as an
  62. unprotected shareware program. I suggest a fee of 20$ if you use ABCDirectory,
  63. but feel free to send me as much money (gifts, praise, nice letters, chocolate,
  64. modules or anything you might come up with) as you think this work deserves
  65. [all of my passion is in this baby!!]. If you believe that this magical utility
  66. is not worth anything, write to me & tell me WHY! You might just give me bril-
  67. liant ideas... Hey, ABCDir's a big kid, he'll get over the critisisme &
  68. come out a winner!
  69.  
  70.  
  71. So here's the address where letters will come in industrial quantity:
  72.  
  73.  
  74.                  le  chef    Marc Dionne
  75.                    \  /    ~    ~
  76.                   _ /\ _    350 Surrey
  77.                 \/    Baie D'Urfe, Québec
  78.                    /  \    H9X 3V8
  79.                 du  soleil    Canada
  80.  
  81.  
  82.                   I'd love to hear from YOU, fellow AMIGA user
  83.                       ~~~~
  84.  
  85. PS: I'm attending the «Ecole Polytechnique» university in Montréal [Bachelor's
  86. in Engeneering] & I'm in need of cash!!
  87.  
  88.  
  89.  
  90. ­­­­­­­­­­­­­­­­­­­­­­­­­­­­­ P A I D ­ U S E R S ­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­
  91.                               ~ ~ ~ ~   ~ ~ ~ ~ ~
  92. This section is dedicated to all the users of ABCDir who have sent a contribu-
  93. tion to help its development. Merci les amis!
  94.  
  95. None.
  96.  
  97.  
  98.  
  99. ­­­­­­­­­­­­­­­­­­­­­­­­­­­ I N S T A L L A T I O N ­­­­­­­­­­­­­­­­­­­­­­­­­­­­
  100.                             ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  101. The following files are contained in this archive/directory. They should not
  102. be modified in any way, shape or form. Also, they MUST be distributed together
  103. AT ALL TIMES. Absolutely NO money may be made from the copying of these files.
  104. If you paid to get these specific files, you got RIPPED OFF. Also, they are not
  105. to be included with any program without my written consent. [this, of course,
  106. excludes the two libraries]
  107.  
  108. ABCDir            AmigaDOS2.0 version of my program. It could be renamed
  109.             to ABC & put into your «c:» directory.
  110. ABCDir.info
  111. ABCDir.desc        A short & sweet description of ABCDirectory.
  112. ABCDir.doc        THIS FILE!!
  113. ABCDir.doc.info
  114. ABCDir.filetypes    Some filetypes to start things up. To be copied to your
  115.             s: directory.
  116. ABCDir.future        ABCDir's future...
  117. ABCDir.future.info
  118. ABCDir.history        Modifications done to ABCDir from the start.
  119. ABCDir.history.info
  120.  
  121. powerpacker.library    This library enables ABCDir to read powerpacked files.
  122.             Note that it is optional & is NOT required to run
  123.             this program.
  124. req.library        This library enhances the scrolling & is necessary if
  125.             you want to change the colors ABC uses. Also optional.
  126.  
  127.  
  128.  
  129. ­­­­­­­­­­­­­­­ D I S P L A Y ­ & ­ G A D G E T ­ A C T I O N S ­­­­­­­­­­­­­­­­
  130.                 ~ ~ ~ ~ ~ ~ ~   ~   ~ ~ ~ ~ ~ ~   ~ ~ ~ ~ ~ ~ ~
  131.       .---.---------------------------------------------------------.---.
  132.       | 0 |                                                         |   |
  133.       |---^---------------------------------------------------------^---|
  134.       |                               18                                |
  135.       |--------------.---.-.-------.-------.-------.-.---.--------------|
  136.       |       2      | 3 |4|  10   |  11   |  10   |5| 3 |      2       |
  137.       |------.---.---+---+-+-------^-------^-------+-+---+---.---.------|
  138.       |  12  | 6 | 7 | 8 |9|          21           |9| 8 | 7 | 6 |  12  |
  139.       |------^---^---^---+-+-----------------------+-+---^---^---^------|
  140.       |                  | |                       | |                  |
  141.       14       15        | |                       | |       15        14
  142.       |                  | |          13           | |                  |
  143.       |------------------+-|                       |-+------------------|
  144.       |        16        |1|                       |1|       16         |
  145.       |------------------^-^-----------------------^-^--.-.-------------|
  146.       |                                                 | |             |
  147.       |                        19                       | |    20       |
  148.       |                                                 | |             |
  149.       `-------------------------------------------------^-^-------------'
  150.  
  151.  0. Close gadget to quit ABCDirectory. A confirmation requester will pop up
  152.     in case you hit it by mistake. The ESC key also performs this. Don't
  153.     forget to close the shell with an «endcli» !!!
  154.  
  155.  1.«Selected/Total bytes» on/off switch. Modifies the information the
  156.     directory information [16] line gives.
  157.  
  158.  2. Command gadgets which can be defined when the define [4] gadget is on.
  159.  
  160.  3. Volume gadgets which will flip the display of the volume list [20] in its
  161.     corresponding file list [15].
  162.  
  163.  4. Flips define on/off. This permits you to define the command gadgets [2] &
  164.     [13]. When this mode is on, the «D» will be red & the command gadgets'
  165.     contour will light up in red.
  166.  
  167.  5.«Buffered/remembered directory kill» on/off switch. The «K» will be in red
  168.     when it is on. Clicking on a buff/rem dir will then kill it. This is useful
  169.     for freeing up memory.
  170.  
  171.  6. The file info display gadget determines what information gets displayed
  172.     after each entry in the file lists. It will toggle between BYTES, BLOCKS,
  173.     TIME-DATE, COMMENT & PROTECTION. The right mouse button will toggle
  174.     through the sorting modes in the opposite direction.
  175.  
  176.  7. The sorting mode gadget determines how files get sorted. It will toggle
  177.     between BY NAME, BY EXTENSION, BY SIZE, BY DATE & BY COMMENT. The right
  178.     mouse button will toggle through the sorting modes in the opposite
  179.     direction.
  180.  
  181.  8. Rereads the current directory.
  182.  
  183.  9. Forces ABCDirectory to remember the current directory.
  184.  
  185. 10. The arrow on the left copies the contents of the right file box to the
  186.     left's. If it is lit, then files will originate from the right file list,
  187.     and vice versa.
  188.  
  189. 11. Flips the two file lists.
  190.  
  191. 12. The name of the current directory.
  192.  
  193. 13. Command gadgets. These are the same as [2], except that they may not always
  194.     be visible because of the scrollbar.
  195.  
  196. 14. Parent gadgets. Goes back one directory.
  197.  
  198. 15. The file lists where files are listed (heavy sentence).
  199.  
  200. 16. Gives information on the current directory; Shows how many files are
  201.     selected over the total number of files, how many dirs are selected over
  202.     the total number of dirs & finally how much room is left on the disk.
  203.     (in kilobytes, or megabytes, depending on how much is left. note that 1
  204.     Kbyte isn't 1024 bytes, it's 1000 bytes)
  205.  
  206.     It can also display how many bytes are selected over the total. This can
  207.     be changed using the «Selected/Total bytes» on/off switch [1].
  208.  
  209.     They are also used to change the display size.
  210.  
  211. 18. Gives online help on the flash gadgets & DOS errors.
  212.  
  213. 19. Shell window. Yeah, it's the real thing. It operates just like any old
  214.     shell except that it doesn't execute s:shell-startup when it gets opened
  215.     due to forces beyond my grasp (yet..) & I don't know how to close it...
  216.     Don't forget to close it when changing screen modes & when quitting.
  217.  
  218. 20. Volume list. Contains all the device, volumes, assigned, buffered &
  219.     remembered dirs available. Clicking on the right side of the list will
  220.     load that dir onto the right file list & vice versa. A yellow line on
  221.     either border of that list indicates on which side the dir will be loaded.
  222.  
  223. 21. Command scroll gadget. Horizontal scrolling browses through all of the
  224.     command lists. Vertical scrolling moves through the current one.
  225.  
  226.  
  227.  
  228. ­­­­­­­­­­­­­­­­­­­­­­­­­­ M O U S E ­ A C T I O N S ­­­­­­­­­­­­­­­­­­­­­­­­­­­
  229.                            ~ ~ ~ ~ ~   ~ ~ ~ ~ ~ ~ ~
  230. The left mouse button selects/deselects files & activates gadgets. You can
  231. select files farther than the file box window simply by moving higher/lower
  232. than the file box while still holding the mouse button.
  233.  
  234. Double clicking (still with the left mouse button) on a directory or single
  235. clicking in a VOLUME list will load a directory into one of the file box.
  236.  
  237. Double clicking on a file will perform a filetype action on it. [see the
  238. filetype section]
  239.  
  240. Left-right clicking (holding down the left mousebutton, then clicking the right
  241. one) on a directory will load it on the opposite side.
  242.  
  243. Left-right clicking on a file will perform a filetype action on it. [see the
  244. filetype section]
  245.  
  246. Left-right clicking will not work if you are using ClockDJ & may not work with
  247. other programs that steal imput events. This annoys me greatly as there are NO
  248. windows to move on MY screen. [needless to say, ClockDJ hit the trash & I
  249. programmed my own clock]
  250.  
  251. The right mouse button scrolls all of the lists in ABCDir, so you don't have
  252. to lose time going to the arrow/scroll gadgets. If you want to acess the menus,
  253. go to the top of the display. [just like DeluxePaint]
  254.  
  255.  
  256.  
  257. ­­­­­­­­­­­­­­­­­­­­­­­ K E Y B O A R D ­ A C T I O N S ­­­­­­­­­­­­­­­­­­­­­­­­
  258.                         ~ ~ ~ ~ ~ ~ ~ ~   ~ ~ ~ ~ ~ ~ ~
  259. ESCAPE will quit a requester or the program. Don't worry, a confirmation
  260. requester'll pop up so you can't quit by accident.
  261.  
  262. RETURN or ENTER will confirm a requester.
  263.  
  264. Any key will abort an ongoing operation; say loading a directory or
  265. copying files. Here again, a confirmation requester will pop up.
  266.  
  267.  
  268.  
  269. ­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­ C O M M A N D S ­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­
  270.                                 ~ ~ ~ ~ ~ ~ ~ ~
  271. Note: a '>' means the command isn't implemented yet & the word «files» implies
  272.  selected files. /\ & \/ denote the start & end of a cycle gadget.
  273.  
  274.  
  275.  
  276. /\Act on origin        The command will act on files selected in the origin
  277.             filelist.
  278.   Act on destination    The command will act on files selected in the dest-
  279.             ination
  280.   Act on left file list    The command will act on files selected in the left
  281.               filelist regardless of what the origin is.
  282. \/Act on right file l.. The command will act on files selected in the right
  283.             filelist regardless of what the origin is.
  284.  
  285.  
  286.                                       RED
  287.      commands play with actual files; they either create or delete things.
  288.  
  289. Delete        Deletes the files.
  290. Copy        Copies the files.
  291. Copy as        Copies the files using a new name.
  292. Copy to device    Copies the files to a device.
  293. Move        Copies the files then deletes them. It simply renames them
  294.         if they are located on the same disk.
  295. Move as        Moves the files using a new name.
  296. Duplicate    Makes a copy of the selected files using a new name under the
  297.         same directory. Note that if directories are duplicated, the
  298.         opposite side will be used.
  299. Reduce        Copies as many files as will fit on the destination, leaving
  300.         only one block (if possible) free. That block is not a short-
  301.         comming of ABCDir, but of AmigaDOS. Note that Reduce does NOT
  302.         take into account files which already exist on the destination.
  303.         [The algorythme used is based on code by Christian Warren]
  304. Create        Creates a file.
  305. Make dir    Creates a directory.
  306.  
  307.  
  308.                                     YELLOW
  309.            commands will (generally) simply modify file attributes.
  310.  
  311. Modify        Displays information on the files and allows its attributes
  312.         (name, comment & protection) to be changed.
  313. Rename        Changes the files' names.
  314. Relabel disk    Brings up info on the disk in the origin filelist & allows its
  315.         name to be changed.
  316. Set comment    Changes the comment to be used for «Comment».
  317. Comment        Changes the comment of the files to the one defined using the
  318.            «Set comment» command.
  319. Set protect    Change the protection bits to be used for «Protect».
  320. Protect        Changes the protection of the files to the one that was
  321.         selected using the «Set protect» command.
  322. List archive    Lists the contents of the files using the filetype whose
  323.         command flag bears the same name.
  324. Xtract archive    Extracts the contents of the files using the filetype whose
  325.         command flag bears the same name.
  326. Add to archive    Adds the files to an archive. Same as for the other two.
  327.  
  328.  
  329.                                      GREEN
  330.    commands are pretty harmless... and are almost all related to filetypes.
  331.  
  332. >File type act    Performs a command only on a certain file type. It will first
  333.         of all ask you which file type to act on, then what command to
  334.         do. This is very handy if, for example, you want to delete all
  335.         the pictures in a directory.
  336. Click-click    Does the same thing as double clicking on all of the files.
  337. Left-right clk    Does the same thing as left-right clicking on all of the files.
  338. Read        Reads the files using the integrated text reader.
  339. Hex Read    Reads the files in hexadecimal mode.
  340. Print        Prints the files with the programs that correspond to their
  341.         types.
  342. Other        Acts as if you double clicked on all the files but only the
  343.         filetypes with the «Other» keyword were acted upon.
  344. Run        Runs the program defined within this gadget. Right after OK has
  345.         been clicked, another requester will pop up. Read the «run
  346.         command» section for more information.
  347. Launch        Identical to Run except that it is used to launch a program &
  348.         therefore does not need any selected file.
  349.  
  350.  
  351.                                      BLUE
  352.           commands play with, or display, file/dir/disk informations
  353.  
  354. Load dir    Loads a specific path into one of the displays.
  355. Mark files    Identical to «Click-click», except that it asks you after each
  356.         file if you want it selected.
  357. Select all    Selects all the files.
  358. Select none    Deselects all the files.
  359. Select pattern  Selects files using the AmigaDOS pattern matching. Refer to
  360.         the AmigaDOS 2.0 manuals to find out more about patterns.
  361. Reselect    Selects the entries that were selected before the operation
  362.         took place.
  363. Flip selected    Selected files will be deselected & vice versa.
  364. Top        Sends selected files to the beginning (top) of the file list.
  365. Bottom        Sends selected files to the end (bottom) of the file list.
  366. Resort        Resorts the file list. Usually used after Top or Bottom.
  367. Does it fit?    Checks to see if the files you've selected fit on the
  368.         destination. Not yet «block accurate».
  369. Get dir size    Computes the size of the files in the selected dirs. Once this
  370.         has been completed, those dirs will have their size displayed
  371.         instead of the regular «DIR» word. This is useful to see if
  372.         they will fit on the destination directory.
  373.  
  374.  
  375.                                      WHITE
  376.                           commands are quite passive
  377.  
  378. Nothing        Does abAsolutEly NOTHING. This can be useful if you want to
  379.         write something amongst your commands.
  380. Iconify        Closes the ABCDir screen & opens a small window on the WB
  381.         screen, press the right mouse button to get back to things.
  382. Configuration    Brings up a requester to modify the defaults.
  383. Load defaults    Loads the defaults from the file «s:ABCDir.config». This file
  384.         may be powerpacked. DON'T FORGET to close the shell before
  385.         executing this command, or you will have a leftover screen.
  386. Save defaults    Saves the defaults to the file «s:ABCDir.config».
  387. File types    Brings up a requester to edit file types.
  388. Load types    Loads the filetypes from the file «s:ABCDir.filetypes». This
  389.         file may be powerpacked.
  390. Save types    Saves the filetypes to the file «s:ABCDir.filetypes».
  391. About        Displays some info about ABCDirectory.
  392. Quit        Lets you quit ABCDirectory, a requester will open up to
  393.         determine if you really want to quit.
  394.  
  395.  
  396.  
  397. ­­­­­­­ O P T I O N S ­ F O R ­ R U N  &  L A U N C H ­ C O M M A N D S ­­­­­­­­
  398.         ~ ~ ~ ~ ~ ~ ~   ~ ~ ~   ~ ~ ~     ~ ~ ~ ~ ~ ~   ~ ~ ~ ~ ~ ~ ~ ~
  399.  
  400. This requester defines all of the available options for the «Run» & the «Launch»
  401. commands.
  402.  
  403.  
  404. Text    The text to be displayed when executing a run command, such as
  405.        «Viewing pictures».
  406. Comm    The actual command line to be executed. Syntax:
  407.  [[    Simply inserts a «[».
  408.  [rt]    Brings up an OK/CANCEL requester with «t» as the title (optional). A
  409.     CANCEL stops the processing of the run command.
  410.  [st:d]    Brings up a string requester with «t» as the title (optional) and «d»
  411.     as the default text to be in the requester (optional). The returned
  412.     string will be inserted if the requester is answered with an OK. A
  413.     CANCEL stops the processing of the run command.
  414.  [f    Inserts file(s) name(s).
  415.  [o    Inserts the origin dir name.
  416.  [d    Inserts the destination dir name.
  417. Dir    Only used in conjunction with the «Change dir to «Dir» option.
  418.  
  419.  
  420. /\Enter dirs            Recursively enters dirs.
  421.   Add «/#?» to dirs        Adds «/#?» to dirs.
  422.   Add «/*» to dirs        Adds «/*» to dirs
  423.   Add nothing to dirs        Plain vanilla name of the dir.
  424. \/Ignore dirs            Skips dirs.
  425.  
  426. /\Change dir to «Dir»        Does a ChangeDir to «Dir».
  427.   Change dir to origin        Does a ChangeDir to the origin dir.
  428. \/Change dir to destination    Does a ChangeDir to the destination dir.
  429.  
  430. Add path to each entry        Adds the complete path to each entry.
  431. Enclose entries in quotes    Encloses entries in quotes.
  432. Act on one entry at a time    Acts on one entry at a time if selected,
  433.                 otherwize does as many as can fit in a 256
  434.                 bytes long string at a time.
  435. Edit command line before    Lets you edit the command line before
  436.                 proceding.
  437. Execute in background        Launches a new process so that ABCDir can go
  438.                 on with life.
  439.  
  440. /\CLI on WB            Opens an output window on the Workbench.
  441.   CLI on ABCDir's screen    Opens an output window on ABCDir's screen.
  442.   ABCDir's CLI            Output goes to ABCDir's CLI.
  443. \/No CLI            No output window is opened.
  444.  
  445. /\No WB to front/back        Does no WorkbenchToFront/Back.
  446.   WB to front before        Brings the Workbench to front before.
  447.   WB to front after        Brings the Workbench to front after.
  448. \/WB to front before & back...    Brings the Workbench to front before & sends
  449.                 it to the back after.
  450.  
  451. Wait after            Waits for you to close the output window after.
  452.                 This only works if one has been previously
  453.                 opened.
  454. Reload origin after        Reloads the origin dir after.
  455. Reload destination after    Reloads the destination dir after.
  456.  
  457.  
  458.  
  459. ­­­­­­­­­­­­­­­­­­­­­­­­­­ C O N F I G U R A T I O N ­­­­­­­­­­­­­­­­­­­­­­­­­­­
  460.                            ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  461. Note: '>' means the flag isn't implemented yet
  462.  
  463.  
  464. This requester modifies ABCDirectory's defaults. Don't forget to close the shell
  465. before clicking OK, or else you'll be stuck with an open screen.
  466.  
  467.  
  468. Confirm del operation    Asks before it starts deleting anything.
  469. Confirm file deletion    Asks before deleting files.
  470. Confirm dir deletion    Asks before deleting a directory.
  471. Ignore del protection    Deletes files even if they're protected from deletion.
  472. >/\Always replace    Always replaces files.
  473. >  Never replace    Never replaces files.
  474. >  Replace if older    Replaces files if they are older.
  475. >\/Ask before replacing    Asks before replacing files.
  476. >Act on icons also    Perform all actions on the files' respective icons.
  477. >Create icons with dirs    When a «Make dir» command is executed, the new dir
  478.             will have an icon identical to the one defined in the
  479.             «Makedir icon» string (defined below).
  480.  
  481. Autoselect icons    When a file is selected, its accompanying icon is
  482.             selected.
  483. Hide hidden files    Files with the HIDDEN protection bit set will not be
  484.             loaded from disk.
  485.             Note: The effects of changing this option won't be
  486.             immediate. Already loaded dirs with hidden files will
  487.             have to be reloaded.
  488. Clone date        The date of the original file is copied also.
  489. Clone protection    The protection of the original file is copied also.
  490. Clone comment        The comment of the original file is copied also.
  491. >Check space before copy Checks if there is enough room on the destination
  492.             disk before starting the copy operation. Note that it
  493.             won't recursively check directories.
  494. Set archive bit after..    Sets the archived protection bit after copying the
  495.             file.
  496.  
  497. Display directory loa.. Shows the files being loaded. Useful on floppies with
  498.             tons of files. If the files you want to play with have
  499.             been loaded, you can then abort the load.
  500. Expand paths        Expands the name of the directory. For example, say
  501.             "here:" is assigned to "workbench:c/". If you type
  502.             "here:" in the dir name box, it will be converted to
  503.             "workbench:c/".
  504. Reload dir if modified    If a certain directory has been buffered, but it has
  505.             been modified, it will be loaded from disk instead of
  506.             taken from the list. This helps ensure that what you
  507.             see is what's really on the disk.
  508. Refresh other side if.. Refreshes the opposite side if one of them is modified
  509.             & they are equal (same directory).
  510. >Auto disk change    Re-reads a directory when a new disk is inserted in
  511.             the drive.
  512.  
  513. /\Flexible origin    The origin will be able to change.
  514.   Origin on left    The origin will always remain on the left. Note that
  515.             you won't be able to perform ANY operations on the
  516.             right side unless a gadget acts specifically on that
  517.             side.
  518. \/Origin on right    Same as the previous, but this time for the right side.
  519. /\Show dirs first    Shows the directories before the files.
  520.   Show files first    Shows the files before the directories.
  521. \/Mix files & dirs      Files & directories will be mixed.
  522.             Note: Already loaded dirs won't be resorted automa-
  523.             tically after you change this. They will have to be
  524.             resorted manually or reloaded.
  525. Show progress        Deselect files as they are acted upon. The advantage
  526.             of not having this enabled is that it speeds things
  527.             up.
  528. Follow operation    Moves the list down to follow an operation taking
  529.             place. This option is automatically off if Show
  530.             progress is off.
  531. Flash gadget help    Displays short online help when the mouse goes over
  532.             cortain gadgets.
  533. Shell            Opens up a shell in the left lowest corner of the
  534.             display. The shell can only be closed with an endcli
  535.             and I know of no other way to do it as of this
  536.             writting. Suggestions appreciated!
  537. /\Interlaced        Full height interlaced screen        640x4xx
  538.   Half-height interla.. Half height interlaced screen        640x2xx
  539. \/Non-interlaced    Full height non-interlaced screen    640x2xx
  540.             Note: The xx depends on the vertical size of your
  541.             WorkBench screen. Report any problem with non-
  542.             standard WB screens.
  543. /\8 colors        8 color screen
  544.   4 colors        4 color screen
  545. \/2 colors        2 color screen
  546.  
  547. >Command lists        Number of command lists.
  548. >Commands/list        Number of commands per command list.
  549. Buffered dirs        Number of directories to keep in memory.
  550. Makedir's icon        Name of the icon to use when creating a directory.
  551.             If it's empty, no icon is created.
  552.  
  553.  
  554.  
  555. ­­­­­­­­­­­­­ B U F F E R E D ­ & ­ R E M E M B E R E D ­ D I R S ­­­­­­­­­­­­­­
  556.               ~ ~ ~ ~ ~ ~ ~ ~   ~   ~ ~ ~ ~ ~ ~ ~ ~ ~ ~   ~ ~ ~ ~
  557. Buffered directories (BuffDirs) are totally managed by ABCDirectory. When a
  558. new directory is accessed, the present file list is saved as a BuffDir. It
  559. will be placed before all other BuffDirs. If the maximum number of BuffDirs is
  560. exceeded, the last BuffDir accessed (lowest in the volume list) will be
  561. removed.
  562.  
  563. If a directory is to be loaded & it happens to have been previously saved, it
  564. will be taken from the BuffDir list & it's corresponding entry in the volume
  565. list will be removed. Note that a directory WILL be loaded from disk if the
  566. directory has been modified since it was saved. This can be over-ridden with
  567. the "Reload dir if modified" option in the configuration. This DOES NOT apply
  568. to the other type of saved directory: remembered directories.
  569.  
  570. Remembered directories (RemDirs) are left at the user's total control. They are
  571. created using the R (Remember) gadget & they will ONLY be removed using the K
  572. (Kill) gadget (or when you quit). If a RemDir has been created & the R gadget
  573. is hit again on the same dir, the RemDir will be freshened instead of
  574. duplicating itself.
  575.  
  576. The only thing that RemDirs & BuffDirs have in common is that they prevent
  577. useless disk access from occuring. (ok, ok, so maybe it's not the only thing,
  578. but... hey, isn't that the Simpsons I hear?)
  579.  
  580.  
  581.  
  582. ­­­­­­­­­­­­­­­­­­­­­­­­­­­­ T E X T ­ R E A D E R ­­­­­­­­­­­­­­­­­­­­­­­­­­­­­
  583.                              ~ ~ ~ ~   ~ ~ ~ ~ ~ ~
  584. ABCDirectory has a relatively fast and versatile text reader built into it.
  585. It is capable of interpreting simple ANSI files which change the style and color
  586. of text (note that bold isn't supported due to the smallness of the font). Tabs
  587. are 8 characters wide (might change) & page breaks are shown as lines.
  588.  
  589. The numeric keypad (Home, End, Pg Up etc..), arrow keys & ALT/SHIFT keys can be
  590. used to maneuver through the file.
  591.  
  592.  
  593.  
  594. ­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­ S H E L L ­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­
  595.                                    ~ ~ ~ ~ ~
  596. ABCDirectory boasts a wonderous (& let's not forget, very nice) 80 column shell
  597. which will NEVER EVER block your view. This means no more switching to the work-
  598. bench screen to do a simple shell operation.
  599.  
  600. I've spent loads of time trying to figure this one out... but unfortunatly, I'm
  601. still stuck: my program can't close the darn thang. Of course, you, the user,
  602. can close it (& must if you don't want to loose any precious memory when ABCDir
  603. quits or when you change the configuration) by typing in an «endcli». If you
  604. know of a way to get around this, I will VERY gradly listen!
  605.  
  606.                  ¡¡ NEVER FORGET TO CLOSE THE SHELL BEFORE !!
  607.  1. Quitting.
  608.  2. Loading the defaults.
  609.  3. Changing screen resolution/# of colors.
  610.  
  611. Note: if this is a hassle for you, you can either a) find me a way for to close
  612. it, or b) use the config option «Shell» to turn it off completely.
  613.  
  614.  
  615.  
  616. ­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­ F I L E T Y P E S ­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­
  617.                                ~ ~ ~ ~ ~ ~ ~ ~ ~
  618.  
  619. This is probably the most powerful tool ABCDirectory posesses, as filetypes
  620. are its dictionary. They represent all of the types of files (LZH/LHA, ZOO, ARC,
  621. pictures, etc.) which can be handled by ABCDir & to which special actions may be
  622. attached. Here's how ABCDir determines if a file corresponds to a certain
  623. filetype:
  624.  
  625.  1. If the Filename pattern exists, it tries to match it with the filename of
  626.     the file.
  627.  2. If the «must match» flag [defined below] is on and the pattern is not cor-
  628.     responding, then the file is considered NOT to be of this filetype. It then
  629.     skips to the next filetype. [see note in «must match» flag below]
  630.  3. Repeats steps 1 & 2 for Sequence & Comment.
  631.  4. If one of these three (Filename, Sequence or Comment) is true, then the file
  632.     is said to be of this filetype. Otherwize, the next filetype is examined. At
  633.     least ONE «must match» flag must be set per filetype or you will encounter
  634.     some problems. This is not true if you set the command to «Add archive». See
  635.     below.
  636.  
  637.  
  638. ADD        Adds a new filetype to the list.
  639. REMOVE        Removes the current selected filetype from the list.
  640.  
  641.  
  642. Name        The name of the filetype, such as «LHA archive».
  643. Filename    The filename pattern associated with the filetype.
  644. Sequence    The HEX sequence associated with this filetype which may contain
  645.         wildcards. Only the first 32 bytes of a file will be loaded to
  646.         match it, but only 16 bytes may be matched if no wildcard is
  647.         used. The reason for this is to save space. Don't forget to end
  648.         your pattern with a * [or #?], or it will NEVER    match [unless
  649.         the file is under 32 bytes...].
  650. Comment        The comment pattern associated with this filetype.
  651.  
  652. Right next to these three gadget is a flag called «must match». If it is on,
  653. then the file must correspond EXACTLY to that pattern, or else it won't be
  654. considered to be of that filetype. Note: at least one «must match» flag must be
  655. set per filetype or you will encounter some problems. The filetype with the «Add
  656. archive» option does not require any pattern matching. It is only invoked when
  657. the «Add arhive» command is hit.
  658.  
  659. It should also be noted that if more than one «must match» flag is on, only ONE
  660. of them has to match.
  661.  
  662.  
  663. The options on the left are the same as those for the run command except for
  664. the last two which are defined below:
  665.  
  666. /\Don't act on click    The filetype has no immediate action.
  667.   Act on double click    If you double click on a file, use the Click-click
  668.             command or use the Mark command, ABCDir will ONLY
  669.             search for the filetypes having this flag on. It then
  670.             executes the command associated with the filetype on
  671.             the file [if it found one].
  672. \/Act on left-right c.. If you left-right click on a file or use the Left-right
  673.             command, ABCDir will ONLY search for filetypes with
  674.             this flag. It then executes the command associated with
  675.             the filetype on the file [if it found one].
  676. /\List archive        If you define a gadget as a «List archive» command &
  677.             click on it, if ONLY searches for filetypes having
  678.             this flag on. It then executes the command associated
  679.             with the filetype on the file [if it found one].
  680.   Xtract archive    Ditto.
  681.   Add archive        Ditto.
  682.   Read            Ditto.
  683.   Hex Read        Ditto.
  684.   Other            Ditto.
  685.   Print            Ditto.
  686.   Run            This filetype's run command is only accessible in
  687.             conjunction with the «Act on double click» flag or the
  688.             «Act on left-right click» flag.
  689. \/Nothing        Does absolutely & utterly NOTHING about this filetype!
  690.  
  691.  
  692.  
  693.  
  694. ­­­­­­­­­­­­­­­­­­­­­­­­ T E C H I E S ­ S E C T I O N ­­­­­­­­­­­­­­­­­­­­­­­­­
  695.                          ~ ~ ~ ~ ~ ~ ~   ~ ~ ~ ~ ~ ~ ~
  696. ABCDirectory is written in «C» & compiled with the SAS/C 6.2 compiler using
  697. short integers, registerized parameters, peephole optimizer & global optimizer.
  698. The system used to do this dirty job is an Amiga 2000 with a 68010, a 105 meg
  699. HD & 3 megs of memory. Yay.
  700.  
  701.  
  702.  
  703. ­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­ S A L U T ­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­
  704.                                    ~ ~ ~ ~ ~
  705. Christian Warren: un môdit bon gars! Merci pour tout ton aide et pour m'avoir
  706.  forcé à faire un font de six pixels de large. Sans toi, ABCDir n'existerait
  707.  sûrement pas.
  708.  This is the guy that made the best disk editor in the whole wide world:
  709.  DEKSID. He also gave me an algorythme for the Reduce command which is mucho
  710.  better than Dread.
  711.  
  712. Timm Martin: Big thanks for that bug in SID v1.06... without it, ABCDir wouldn't
  713.  be here, I wouldn't be a «C» wizzard & I'd most probably be registered to SID
  714.  today. Competition is a wonderful... sometimes.
  715.  
  716. Mon père: merci pour le support et l'encouragement.
  717.  
  718. Hrothgar: thanks for those manuals... they come close to being very handy.
  719.  
  720. Allain Regainbald: mon monarque d'amour enjolivateur de courroies Pirelli!
  721.  
  722. Robert [ARREX] Williamson: thanks for the positive & constructive comments.
  723.  
  724. my dog: veux-tu aller prendre une marche Joe? (pis le chien jump sur les
  725.     murs, y fait des pirouettes et je l'aime le fou !!!)
  726.  
  727. Lars Magnus Nordeide: For his more than inspiring Wisecrack program which
  728.  lightens me up at every boot.
  729.  
  730. Et salut aussi à ceux qui suivent [dans un désordre assez parfaitement logique
  731.  merci!]: Dominic [Moose] Labrosse, John [la Ronde] Gilbert, Pierre
  732.  [Distribution Au Konsommateur] Baillargeon, Sean Mollit, Sir Nigel Flash,
  733.  Larry Laffleur, mon popa, mon chien [pour m'avoir dérangé si souvent] et Paul
  734.  [The Beast] Ladouceur.
  735.  
  736.  
  737.  
  738. ­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­ B L A H ­ B L A H ­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­
  739.                                ~ ~ ~ ~   ~ ~ ~ ~
  740.  Playboy: Homme élégant au physique avantageux qui recherche le succès
  741.  féminin.
  742.     [dictionnaire Larousse de poche]
  743.  
  744. «Comme le disais le vieux sage couché sur un tas de scrap du port de
  745.  Montréal...:"Nul n'est a l'abri des flux et des reflux du temps...celui qui
  746.  s'imagine que tous les fruits murissent en même temps que les fraises ne
  747.  connait rien aux framboises et aux raisins."»
  748.     [Allain Regainbalde]
  749.  
  750.  Un ami est un élu que nous extrayons de notre indifférence universelle.
  751.  
  752. «A master's secrets are only as good as the master's ability to explain them
  753.  to others.»
  754.     [Michael Sinz]
  755.  
  756. «Everybody keep calm. It's all under control, there's nothing to see. It is
  757.  merely a major scientific breakthrough.»
  758.  
  759. «On se doit d'apprécier le temps que nos amis nous consacrent car il est de
  760.  quantité limité.»
  761.     [le chef du soleil]
  762.  
  763.  
  764.  
  765. ­­­­­­­­­­­­­­­­­­­­­­­­ H O W ­ T O ­ R E A C H ­ M E ­­­­­­­­­­­­­­­­­­­­­­­­­
  766.                          ~ ~ ~   ~ ~   ~ ~ ~ ~ ~   ~ ~
  767. I hope you have oodles of fun using this proggy. I can be reached at the
  768. following Bulletin Boards (in calling priority):
  769.  
  770.                      Image Électronique   (514) 937-9984
  771.                      Surfside Resort      (514) 624-6319
  772.                      AMIGA ECS            (514) 696-6632
  773.  
  774. also on the XenoLink_util echo
  775.  
  776.  
  777.                  le  chef    Marc Dionne     (514) 457-4580
  778.                    \  /    ~    ~
  779.                   _ /\ _    350 Surrey
  780.                 \/    Baie D'Urfe, Québec
  781.                    /  \    H9X 3V8
  782.                 du  soleil    Canada
  783.  
  784.  
  785. pretzel à bagatelle, EOF